<script type="text/html" data-help-name="e-mail">
    <p>Versand von <code>msg.payload</code> als E-Mail mit <code>msg.topic</code> als Subjekt.</p>
    <p>Der Standard-Nachrichtenempfänger kann im Node vorgegeben werden.
       Wenn nicht angegeben, muss der Nachrichtenempfänger über die <code>msg.to</code>-Eigenschaft
       der eingehenden Nachricht übergeben werden.
       Ebenso können einige oder alle vorgegeben werden von: <code>msg.cc</code>, <code>msg.bcc</code>, <code>msg.replyTo</code>,
    <code>msg.inReplyTo</code>, <code>msg.references</code>, <code>msg.headers</code> oder <code>msg.priority</code>-Eigenschaften.</p>
    <p>Es kann optional auch <code>msg.from</code> in den Nutzdaten (Payload) vorgegeben werden,
       was die eingestellte <code>Benutzer-ID</code> überschreiben würde.</p>
    <h3>Gmail-Benutzer</h3>
    <p>Beim Zugriff auf Gmail kann es nötig sein, entweder <a target="_new" href="https://support.google.com/mail/answer/185833?hl=de">ein App-Passwort</a> zu aktivieren oder den <a target="_new" href="https://support.google.com/accounts/answer/6010255?hl=de">Zugriff aufs Google-Konto durch weniger sichere Apps</a> über die Google-Konto-Einstellungen zu erlauben.</p>
    <h3>Details</h3>
    <p>Die Nachricht in <code>msg.payload</code> kann als HTML formatiert sein.
      Ein separater, davon abweichender Plaintext kann in <code>msg.plaintext</code> angegeben werden. Ansonsten wird auch <code>msg.payload</code> verwendet.
      <code>msg.plaintext</code> wird ignoriert, wenn <code>msg.payload</code> kein HTML enthält.</p>
    <p>Wenn <code>msg.payload</code> ein binärer Buffer ist, so wird sie in einen Nachrichten-Dateianhang (attachment) konvertiert.
       Der Dateiname sollte mittels <code>msg.filename</code> angegeben werden.
       Optional kann <code>msg.description</code> als Nachrichtentext hinzugefügt werden.</p>
    <p>Alternativ kann auch <code>msg.attachments</code> übergeben werden, welches ein Datenfeld (array) mit einen oder mehreren
    Dateianhängen im <a href="https://nodemailer.com/message/attachments/" target="_new">nodemailer</a>-Format enthält.</p>
    <p>Falls vom Empfänger benötigt, kann zusätzlich über <code>msg.envelope</code> ein Objekt übergeben werden, welches typischerweise zusätzliche <code>from</code>- und <code>to</code>-Eigenschaften enthält.</p>
    <p>Wenn ein selbstausgestelltes Zertifikates vorliegt, kann sich Nodemailer darüber beschweren und das Senden der Nachricht ablehnen.
       In diesem Fall kann versucht werden TLS abzuschalten.</p>
    <p><b>Hinweis</b>: Verwendet SMTP mit SSL über Port 465.</p>
    <h3>Sichere Verbindung verwenden</h3>
    <p>Wenn diese Option aktiviert ist, verwendet die Verbindung TLS, wenn eine Verbindung zum Server hergestellt wird. Wenn deaktiviert, wird TLS verwendet, wenn der Server die STARTTLS-Erweiterung unterstützt. In den meisten Fällen setzen Sie dies auf aktiviert, wenn Sie eine Verbindung zu Port 465 herstellen. Lassen Sie es für Port 587 oder 25 deaktiviert.</p>
</script>

<script type="text/html" data-help-name="e-mail in">
    <p>Regelmäßiger Abruf von E-Mails von einem POP3- oder IMAP-Server und Weiterleitung der Nachricht, falls diese noch nicht angezeigt wurde.</p>
    <p>Der Subjekttext wird in <code>msg.topic</code> und der Klartextinhalt in <code>msg.payload</code> abgelegt.
       Wenn text/html vorliegt, dann wird dieser in <code>msg.html</code> abgelegt.
       <code>msg.from</code> und <code>msg.date</code> sind ebenfalls für die weitere Nutzung gesetzt.</p>
    <p>Zusätzlich enthält <code>msg.header</code> den kompletten Mailkopf (Header) als Objekt mit
    <i>to</i>, <i>cc</i> und anderen eventuell nützlichen Eigenschaften.</p>
    <p>Der Node kann optional die Nachricht als gelesen markieren (Standard-Einstellung), sie löschen oder sie als unmarkiert belassen.</p>
    <p>Verwendet wird das <a href="https://github.com/mscdex/node-imap/blob/master/README.md" target="_new">node-imap-Modul</a> -
       siehe dort für Informationen über das <code>msg.criteria</code>-Format, falls benötigt.</p>
    <p>Alle Dateianhänge mitgeliefert in eingehenden E-Mails können in der <code>msg.attachments</code>-Eigenschaft gefunden werden.
       Es wird dann ein Datenfeld (Array) von Objekten übergeben, wo jedes Objekt ein einzelner Dateianhang (attachment) darstellt.
       Das Objektformat ist:</p>
<pre>
{
  contentType:        // Die MIME-Inhaltsbeschreibung (MIME content description)
  fileName:           // Ein vorgeschlagener Dateiname, der diesem Anhang zugeordnet ist
  transferEncoding:   // Wie wurde der ursprüngliche E-Mail-Anhang verschlüsselt?
  contentDisposition: // Unbekannt
  generatedFileName:  // Ein vorgeschlagener Dateiname, der diesem Anhang zugeordnet ist
  contentId:          // Eine eindeutige generierte ID für diesen Anhang
  checksum:           // Eine Prüfsumme gegen die Daten
  length:             // Datengröße in Bytes
  content:            // Der tatsächliche Inhalt der in einem Node.js-Pufferobjekt enthaltenen Daten
                      // Wir können dies in eine base64-Datenzeichenfolge mit content.toString('base64') umwandeln
}
</pre>
<p><b>Hinweis</b>: Bei POP3 sind die Standard-Portnummern 110 für ungesichertes TCP und 995 für SSL. Bei IMAP 143 für ungesichertes TCP und 993 für SSL.</p>
<p><b>Hinweis</b>: Mit der Option 'STARTTLS' kann eine bestehende ungesicherte Verbindung zu einer gesicherten geupgraded werden. Die Einstellung 'immer' versucht dies immer, 'wenn erforderlich' wenn es erforderlich ist, und 'nie' gar nicht.</p>
<p><b>Hinweis</b>: Das maximale Aktualisierungsintervall ist 2147483 Sekunden (24,8 Tage).</p>

</script>

<script type="text/html" data-help-name="e-mail mta">
    <p>Mail Transfer Agent - Portüberwachung für eingehende SMTP-Mails.</p>
    <p><b>Hinweis</b>: "NICHT für Produktivbetrieb", da keine Sicherheitsfunktionen eingebaut sind!
    Dies dient hauptsächlich zum lokalen Testen des Versands ausgehender E-Mails,
    kann jedoch bei Bedarf verwendet werden als Mail-Weiterleitung an einen echten E-Mail-Dienst.</p>
    <p>Um Ports unter 1024 (z.B. 25 or 465) zu benutzen, könnten höhere Zugriffsrechte nötig sein.
    Auf Linux-Systemen kann dieses erreicht werden durch Starten von
    <pre>sudo setcap 'cap_net_bind_service=+eip' $(which node)</pre>
    und Neustart von Node-RED.
    Es ist zu beachten, dass dadurch alle Knotenanwendungen auf alle Ports zugreifen können.</p>
</script>
